echarts自定义信息提示框内容

2024-07-03 10:05| 来源: 网络整理| 查看: 265

默认情况下echarts的图表会提供鼠标移入每个数据标签时的数据提示功能。我们也可以用echarts的 tooltip 配置项来自定义提示框。

这里是 tooltip 官方文档

触发模式

主要有两个触发模式（每个模式触发时可展示的数据数量不同）：

数据项图形触发（即鼠标移到某一个图形时出现信息提示框，多用于单项数据显示；会接收一个对应图形的数据对象）

在这里插入图片描述

坐标轴触发（鼠标只要是移动到X坐标轴某项范围之内就会弹出信息提示框，常用于多项数据展示；会接收X轴某列的数据对象数组）

在这里插入图片描述

配置项tooltip

提示框组件可以设置在多种地方：

可以设置在全局，即 tooltip可以设置在坐标系中，即 grid.tooltip、polar.tooltip、single.tooltip可以设置在系列中，即 series.tooltip可以设置在系列的每个数据项中，即 series.data.tooltip

tooltip中 formatter 属性用来配置自定义样式，属性值可以是一个回调函数或者字符串模板。这里主要说回调函数的实现。

官方文档

自定义数据内容和样式

回调函数参数的对应属性如下

{ componentType: 'series', // 系列类型 seriesType: string, // 系列在传入的 option.series 中的 index seriesIndex: number, // 系列名称 seriesName: string, // 数据名，类目名 name: string, // 数据在传入的 data 数组中的 index dataIndex: number, // 传入的原始数据项 data: Object, // 传入的数据值。在多数系列下它和 data 相同。在一些系列下是 data 中的分量（如 map、radar 中） value: number|Array|Object, // 坐标轴 encode 映射信息， // key 为坐标轴（如 'x' 'y' 'radius' 'angle' 等） // value 必然为数组，不会为 null/undefied，表示 dimension index 。 // 其内容如： // { // x: [2] // dimension index 为 2 的数据映射到 x 轴 // y: [0] // dimension index 为 0 的数据映射到 y 轴 // } encode: Object, // 维度名列表 dimensionNames: Array, // 数据的维度 index，如 0 或 1 或 2 ... // 仅在雷达图中使用。 dimensionIndex: number, // 数据图形的颜色 color: string, // 饼图的百分比 percent: number, }

注意:

主要使用的属性有

seriesName（类目名）marker（提示圆点）value（对应数据）数据项图形触发（单项数据展示）

单项数据展示时回调函数的参数是一个数据对象。

可以通过字符串拼接html片段进行自定义展示数据内容，也可以加自己的HTML字符串片段。

tooltip: { trigger: 'axis', formatter: function (data) { return data[i].marker + data[i].seriesName + ': '+ data[i].value+''; }, }, 坐标轴触发（多项数据展示）

注意：其中的回调函数的参数是一个数组，所以想要数组每项的数据都展示需要遍历拼接html片段。

tooltip: { trigger: 'axis', formatter: function (data) { var text = data[0].name + '', val; for(var i =0; i

【本文地址】

公司简介

联系我们